WOComponentContent allows you to write nested components as HTML container elements: elements that can include text and other elements between their opening and closing tags. Using WOComponentContent you can, for example, write a component that defines the header and footer for all of your application's pages.
The WOComponentContent dynamic element doesn't have any
attributes. It's simply a marker that specifies where the contents
wrapped by the component's <WEBOBJECT> tag
should go.
To write a component that defines the header and footer for some or all of your application's pages, first define a component with HTML similar to the following:
<HTML> <HEAD> <TITLE>Cool WebObjects App</TITLE> </HEAD> <BODY> <!-- A banner common to all pages here --> <!-- Start of content defined by the parent element --> <WEBOBJECT name=ParentContent></WEBOBJECT> <!-- End of content defined by the parent element --> <!-- Put a footer common to all pages here. --> </BODY></HTML>
The <WEBOBJECT> element above is a WOComponentContent element declared like this:
ParentContent : WOComponentContent {};To use this component, wrap the contents of all of your other
components with a <WEBOBJECT> tag
that specifies the component defined above. For example, suppose
you named the above component HeaderFooterPage.wo.
You could use it in another component like this:
<!-- HTML for a simple component wrapped with HeaderFooterPage --><WEBOBJECT name = templateWrapperElement> <P>Hello, world!</P></WEBOBJECT>
Where templateWrapperElement is
declared in the .wod file
like this:
templateWrapperElement : HeaderFooterPage {};At runtime, the contents wrapped by templateWrapperElement are
substituted for the WOComponentContent definition. As a result,
the HTML generated for this component would be:
<HTML> <HEAD> <TITLE>Cool WebObjects App</TITLE> </HEAD> <BODY> <!-- A banner common to all pages here --> <!-- Start of content defined by the parent element --> <P>Hello, world!</P> <!-- End of content defined by the parent element --> <!-- Put a footer common to all pages here. --> </BODY></HTML>
| You can only have one WOComponentContent element in a given component. |